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NOTE TO THE READER 

GETTING STARTED WITH DECsysiem- 10 is a manual that introduces you to the DECsystem-10 
and the TOPS- 10 Operating System. This manual has colored dividers that mark its sections; each 
divider lists procedures for accomplishing specified tasks. For more detailed information, read the 
sections themselves; they describe the tasks more fully. 

We hope that as you read this manual you are sitting at a computer terminal and executing each 
boxed example yourself. The adage "to do is to learn" applies especially to computers. The fas- 
test—and the surest— way to learn TOPS- 10 is to use it! 

We use several conventions within this manual which may be foreign to you. Some of these con- 
ventions are defined below, others are defined within the text. 



Convention 



Meaning 

Wherever this symbol appears, we are indicating that you 
should press the key on the terminal keyboard labeled RE- 
TURN. This symbol is called a carriage return. 



ESC 



Wherever this symbol appears, we are indicating that you 
should press the key on the terminal keyboard labeled 
ESC. This key is called the ESCape key, and when it is 
pressed the system will print a $. Note that on some termi- 
nals this key is labeled ALT (for ALTernate) MODE or 
PREFIX. 



This symbol is called a circumflex and is sometimes 
printed as J (up-arrow). Wherever it appears, we are indi- 
cating that you should press the key on the terminal key- 
board labeled CTRL. This key is called the ConTRoL key. 



RUB' 
,OUT, 



Wherever this symbol appears, we are indicating that you 
should press the key on the terminal keyboard labeled 
RUBOUT. On some terminal keyboards, this key is labeled 
DELETE. When this key is pressed, the most recently typed 
character is deleted. 



Portions of an example which are underlined are the por- 
tions of the example that you must type. The portions not 
underlined are printed by the system. 



UPPER 

CASE 

LETTERS 



The portions of an example that are typed as uppercase let- 
ters are necessary portions of that example or command 
line. You must type the letters exactly as you see them in 
this manual. In the example: 

EXECUTE filenameextension J 

you are to type the word in upper case letters exactly as it 
appears. 



Convention 



Meaning 



lower 
case 

letters 



The portions of an example or command line description 
that are typed in lower case are variable portions that you 
must supply. The letters that you supply for a variable do 
not necessarily have to substitute letter-for-letter. To supply 
a variable for "name" you could use a word of n characters 
in length; you do not have to supply a word with exactly 
four characters. If at any time a character length limitation is 
in effect, we will tell you the legal range. In the example: 



.EXECUTE filename.extension J 

you are to type the word in uppercase letters exactly as it 
appears; you are to substitute a file name and a file name 
extension for the lower case letters. 

Wherever this symbol appears within an example, we are 
indicating that you should press the space bar on the termi- 
nal keyboard. 



TAB 



Wherever this symbol appears, we are indicating that you 
should press the TAB key on the terminal keyboard. If the 
terminal you are using does not have a TAB key, press the 
CTRL key simultaneously with the I key (CTRL/I). 
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PREFACE 



GETTING STARTED WITH DECsystem- 10 \% written for the person who has never used a com- 
puter before and for the person who has never used a DECsystem- 10 before, but who has used 
other computer systems. Those persons who fall into the first category should read the entire 
manual; those falling into the second category might find that reading only the dividers is suffi- 
cient. 

It is not necessary that other books or manuals be read before GETTING STARTED WITH DEC- 
svstem-10. However, upon finishing this manual some of you may wish to read INTRODUCTION 
TO DECsvstem-WSOFTW ARE (DEC-10 MZDC-D), DECsvstem-W OPERATING SYSTEM COM- 
MANDS MANUAL (DEC-10-OSCMA-A-D), and BEGINNER'S GUIDE TO MULTI- 
PROGRAM BATCH (DEC-10-OMPBA-B-D). 



VII 



INTRODUCING YOURSELF TO DECsystem-10 



In order to begin using the system, do the following: 

1. After you turn the terminal on, press the CTRL key. While it is still in the down posi- 
tion, press the C key. This is called typing a CTRL/C. 

2. After you see the period (.),.type the word LOGIN and press the RETURN key. 

3. After you see the #, type your project-programmer number and press the RETURN 
key. 

4. After you see the word PASSWORD:, type your password and press the RETURN 
key. Your password will not be printed. 

Steps 1 through 4 above are called the logging-in procedure. Below is an example of the logging-in 
procedure. 



. LOGIN J 

JOB 32 R5725D SYS #40/2 TTY73 

# 2 7, 4072 J 

PASSWORD:^ 

1131 21-JAN-75 TUE 



If the terminal you are using is not a local terminal (hooked directly to the computer), you must 
make connection with the computer through the use of a telephone. The procedure to establish 
this connection is: 



1 . Turn on the terminal. 

2. Check the speed setting of the terminal (most terminals are labeled either 10 CPS, 15 
CPS and 30 CPS or 110 baud, 150 baud, and 300 baud.) It should initially be set to 
either 10 CPS or 110 baud. 

3. Dial the phone number to the computer. 

4. Wait for a steady tone (sometimes this is a high pitched beep). 

5. Lay the receiver in the slots provided for it either on the terminal or on the acoustic 
coupler. 

6. Wait for the carrier detect light to come on. 

7. If you see nothing printed on the terminal, type two CTRL/Cs until you see either a 
period or the words PLEASE LOGIN OR ATTACH. 

8. Following the logging-in procedure listed above. 



SAYING GOODBYE TO DECsystem-10 

When you are finished using the system, do the following: 

1 . After you see the period, type K/F and press the RETURN key. 

This procedure is called the logging-off procedure. Below is an example of the logging-off proce- 
dure. 



.K/F J 

JOB 32, USER [2 7,4072] LOGGED OFF TTY73 

SAVED ALL FILES (140 BLOCKS) 

RUNTIME 1.54 SEC 



1131 21-JAN-75 



TYPING AN EASY COMMAND 

To get today's date and time, type the word DAYTIME after you see the period. Press the RE- 
TURN key. 



. DAYTIME J 
21-JAN-75 11:32:10 



GETTING ACQUAINTED WITH DECsystem-10 

Before you can use the system, there are several questions for which you need the answers. The 
questions to ask someone at your installation are: 

1 . What project-programmer number should I use? 

2. What terminal can I use? 

3. Is there a document detailing the terminal's use? (If there is no such document, you 
can ask someone at your installation to assist you, or you can experiment with the 
terminal.) 

Your project-programmer number and your password uniquely identify you to the system. A ter- 
minal is the piece of equipment that you use to communicate with the system. 

Project-Programmer Numbers 

A project-programmer number is written in the form: 

nnnnnn,nnnnnn 



T. 



your programmer number is a one to six digit 
number. 

the comma separates the project number 

from the programmer number. 

your project number is a one to six digit num- 
ber. 

The project-programmer number used as an example within this manual is 27,4072. Sometimes 
project-programmer numbers are typed within square brackets or parentheses, like [27,4072J. In 
later sections of this manual where square brackets are required, we will point out that fact. In 
some examples, a project-programmer number will be represented by the letters ppn for abbrevia- 
tion purposes. 

Passwords 

A password allows you to access the system. This password must be typed in order for the system 
to be sure (1 ) that you are who you say you are and (2) that you are authorized to use the system. 
Each user has his/her own secret password. To keep these passwords secret, the password is not 
printed when you type it at the terminal. 

Terminals 

The third piece of information you need before using the system is information about the terminal 
you will be using. You should find out how to turn the terminal on and off. You should notice the 
positioning of some of the keys. Notice particularly, where the following keys are located: 

the CTRL key This key is used to type a control character 

and is further described below. 



the RUBOUT key This key is used to delete characters and is 

further described on page 10. (On some ter- 
minals this key is labeled DELETE.) 

the SPACE bar This bar, when pressed, moves the carriage 

over one space, creating a blank space. 

the SHIFT key This key, when pressed, allows you to type 

any character appearing on the upper half of a 
key. 

the ESC key This key is labeled on some terminals as ALT 

MODE or PREFIX. 

When you are getting acquainted with the DECsystem-10, it is always good practice to use a hard- 
copy terminal— one that prints on paper everything that you and the system communicate to each 
other. If you desire, you can tear off the paper and save it for reference. 

A video display terminal does not have a printing mechanism and does not use paper. Instead, it 
displays the conversation between you and the system on a television-like screen. Obviously, you 
cannot save this type of communication. 



INTRODUCING YOURSELF TO DECsystem-10 

Once you have turned on the terminal, press the CTRL key. While it is still in the down position, 
press the C key. This is called typing a CTRL/C and |C is printed at the terminal. CTRL/C is only 
one of several control characters that help you run the system. 

tC Type a CTRL/C. 

• The system prints a period. 

When you type a CTRL/C, you are interrupting the system, telling it to stop what it is doing and 
listen to you. When it is interrupted, the system prints a period. 

The period is used by the system as a prompt character. A prompt character indicates to you that 
the system has finished what you last told it to do, and it is now ready for you to tell it to do some- 
thing else. 

NOTE 

Sometimes two CTRL/Cs are needed to interrupt the 
system. If you type one or two CTRL/Cs and you do 
not get a period, ask another user who is familiar with 
the DECsystem-10 to help you. 

After you see the . on your terminal, you have to identify yourself to the system. Type the word 
LOGIN directly after the period. Just as the system uses a period to tell you that it has finished a 
function, you must use a carriage return to tell it that you have finished a function. You tell it by 
pressing the RETURN key. (In this manual, a carriage return is indicated byj.) 



The word LOGIN is a command word. The TOPS- 10 Operating System recognizes a great many 
command words; within this manual we will discuss quite a few commands, but not all of them. 
The entire list of recognizable command words and their meanings can be found in Appendix A. 

You type all command words to the system directly after the period prompt character. After you 
type these command words, you must press the RETURN key. With some command words the 
system expects you to supply an argument before you press the RETURN key. 

command argument^ 

An argument supplies a quantity, time, location, device name, or other qualifying data that the sys- 
tem must know in order to perform your command. 

After you type the word LOGIN and press the RETURN key, the system prints a message similar 
to this one: 



. LOGIN J 
JOB 23 

# 



R5725D SYS #40/2 TTY73 



The first line of the message identifies you as being job number 23; you are using the monitor 
named R5725D; you are using system number 40/2; the terminal that you are using is called 
TTY73. The numbers and letters that appear on your terminal will resemble these, but they will 
not be identical. It is not necessary that you know what all of these numbers and letters mean, but 
you should know that they are printed by the system. 

The second line of the system message is a number sign (#). It is printed to prompt you to type 
your project-programmer number. After typing your project-programmer number, press the RE- 
TURN key. 



. LOGIN J 
JOB 23 
# 27.4072 ^ 
PASSWORJJ:^ 



R5725D SYS #40/2 TTY73 



The system prints the word PASSWORD followed by a colon. After the colon, you are to type your 
password. As you type each letter of your password, nothing is printed at the terminal; but the 
letters that you type are passed to the system even though they are not printed. After typing your 
password, press the RETURN key. 



. LOGIN ) 
JOB 2 8 
# 27,42)72 ) 

1134 21-JAN-75 



R5725D SYS #40/2 TTY73 



TUE 



The system will print the message of the day. The message that you see may be somewhat longer 
than this, but its first line will resemble the above. If you do not see this message, but you see in- 
stead 7LGNIET INVALID ENTRY - TRY AGAIN, retype your project-programmer number 
and password. If you again receive the error message, check with someone at your installation. 



SAYING GOODBYE TO DECsystem-10 

When you are finished using the system, you cannot just stand up and walk away from your termi- 
nal. You must first type the characters K/F after the period. Then you must press the RETURN 
key. If you do not log-off the system in this manner, the terminal will not be free for the next user. 



.K/F J 

JOB 28, USER [27,4072] LOGGED 0FFTTY73 1134 21-JAN-75 

SAVED ALL FILES (140 BLOCKS) 
RUNTIME I .47 SEC 



The K portion of the command terminates your communication with the system. The /F portion 
of the command is called a switch and indicates to the system that you want it to save any work 
that you did using the system. If you do not log-off the system in this manner, someone could 
come along and modify your files, copy your files, or do work on the system and charge it to your 
project-programmer number. After you press the RETURN key, the system prints a log-off mes- 
sage. 

This message indicates that you just logged off the system. You were job number 28; you logged in 
with 27,4072 as your project-programmer number; the terminal you were using was labeled 
TTY73; you logged off on January 21. 1975. The second line of the log-off message indicates how 
many seconds the system actually worked for you. 

To continue reading this manual and typing the examples which follow, you will have to log in 
again. 



USING TWO EASY COMMANDS 

Before you do anything with the system, try typing a few easy commands. There are several easy 
commands, but we will discuss only two of them here. 

To have the system tell you the current date and time of day, type the word DAYTIME after you 
see the period. Press the RETURN key. 

. DAYTIME J 
21-JAN-75 Ilt35i23 

* f 

1 the current time 

the current date 



The date is typed by the system in the form: 

day of month - month - year 
The time of day is typed by the system in the form: 

hours minutes : seconds 

Hours are represented using a 24-hour clock. The time that the system typed in the preceding ex- 
ample 1 1:35:23 is 23 seconds after 11:35. Twelve noon is represented as 12:00; twelve midnight is 
represented as 00:00:00: three thirty in the morning is represented as 03:30:00. 

By typing only three letters and pressing the RETURN key, it is possible to have the system type 
pages of information. After you see the period, type the letters SYSTAT and press the RETURN 
key. 



.SYSTATj 










STATUS OF 


R5725D SYS #40/2 AT 11:35 


:31 ON 


21-JAN-75 


UPTIME 4:30: 
31 JOBS IN 


08+4:28:28 
JSt OUT OF 


!, 35+607. NULL TIME 
45. 31 LOGGED IN 


= 33+607.IDLE + 2+07.LOST 
, 3 DETACHED OUT OF 45. (LOGMAX) 


JOB 


WHO 


LINE* 


WHAT SIZE(K) 


STATE 


RUN TIME 


1 
2 

3 
4 
5 
6 

7 


t OPR J 

[OPR] 
[OPR ) 
[OPR ) 
60,60 
[OPR ] 
TO 


DET 

1 
P1J14 
DET 
131 
P0J14 


DAEMON 7+SPY 
FR5725 35 
SYSINF 8 
SAVER 6+ SPY 
DCTMH 16 
LPTSPL 3+4 


SL SW 
TI SW 
HB SW 
HB SW 
tC SW 
DI 


30 

16:54 

I 

1 

2 
4:01 



The information that the system typed for you is system status information concerning every per- 
son that is currently using the system. Within the first table that the system typed, look down the 
second column from the left, find the word [SELF] - that is you! It tells you your job number in the 
first column (the same number you got when you logged in.) Furthermore, it tells you that you are 
using the SYSTAT program, which is the name of the program that is printing all of this system 
status information for you. 

In the example above, we stopped the system from printing information by typing a CTRL/O. You 
do not have to type a CTRL/O, you can wait until the system is finished typing. You can type a 
CTRL/O any time that the system is printing, and it will not harm anything. 



ENTERING YOUR PROGRAM INTO THE COMPUTER 

NOTE 

If you want to use BASIC programming language, you 
do not have to read this section. Turn to the dvider la- 
beled USING BASIC to learn how to get your program 
into the computer. 

Choose a name for the file which will contain your program. If the program you are going to put 
into the file is a FORTRAN program, add .FOR to the end of the name; if it is a COBOL program, 
add .CBL to the end of the name; if it is an ALGOL program, add .ALG to the end of the name. 
.FOR, .CBL, and .ALG are called file name extensions. 

USING THE SOS EDITOR 

1. After you see the period, type R SOS and press the RETURN key. 

2. The SOS editor will print the word FILE followed by a colon. After the colon, type 
the name of your file, a period, and the file name extension. Press the RETURN key. 

3. The system will print INPUT: followed by the name of your file. 

4. The number 00100 is printed by the system. After this line number, type the first 
line of your program and press the RETURN key. 

5. After you see 00200, which is the second line number, type the second line of your 
program, press the RETURN key. 

6. Continue entering your program in this manner: 

a. wait until a line number is printed, 

b. type a line of your program, and 

c. press the RETURN key. 

7. Type the last line of your program and press the ESC key instead of the RETURN 
key. 

8. After you see an asterisk (*), type the letter E and press the RETURN key. 

TYPING MISTAKES (OR FORGET I SAID THAT) 

On this divider, you will learn to correct mistakes made BEFORE pressing the RETURN key. To 
correct mistakes made AFTER pressing the RETURN key, see the section "Editing your Pro- 
gram" on pages 24 and 25. 



DELETE AN ENTIRE LINE 



. LOGGENtU 

LOGIN J 

JOB 28 R5725D SYS #40/2 TTY73 

#27,4072 ^ 
PASSWORDS 
1137 21-JAN-75 TUE 



A CTRL/U, printed as fU, erases an entire line. To type a CTRL/U, press the key labeled CTRL; 
while you hold it down, type a U. 

DELETE ONE OR MORE CHARACTERS 




. LOGGEN \NEG\IN J 

JOB 9 R5725D SYS #40/2 TTY73 

# 27, 4072 y 

PASSWORD:*/ 

1143 21-JAN-75 TUE 



You can delete one or more characters by pressing the RUBOUT key once for each character you 
want to be deleted. Within this example, we wanted to delete G E N. In order to do so, we pressed 
the RUBOUT key three times, then we typed the correct letters (i.e., I N.) 

WHAT DID I TYPE 

To see the corrected line as the system sees it, you can type a CTRL/R before you press the RE- 
TURN key. 



7ru£\ 



. LOGGEN XNEGMN 

LOGINS 

JOB 19 R5725D SYS #40/2 TTY73 

#27,4072 > 

PASSWORD:^ 



CTRL/R DOES NOT PRINT. 



If the line is as you wish it, press the RETURN key after the system prints the corrected line. 
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NTERING YOUR PROGRAM 



Files and Programs 

Before you enter a program into the computer, it is wise to know the definition of the word pro- 
gram and how it is stored in the computer. 

In the first portion of this manual, you typed several TOPS-10 Commands: LOGIN, DAYTIME, 
and SYSTAT. When you pressed the RETURN key, the system executed the command. 

A program is executed also, but in a slightly different manner. A program is made up of 
statements. Each statement tells the system to do something, but that something is not done when 
you press the RETURN key. It is done after: 

1 . You have typed all statements in the program into a file and after, 

2. You have told the system to translate all of the statements in the program to machine 
language. 

If the system is to remember and later execute your program, it must be told to enter the program 
into a file. A file is an ordered set of data that is named and then stored in the system. Usually your 
file and program have the same name. For instance, if you had a program named SORT, it could be 
stored in a file named SORT. You could also store the program SORT in a file called WONDER or 
any other file you wish. (The only restriction is that the file name must not be longer than six char- 
acters.) 

Always keep in mind that you are responsible for how much of your work the system remembers 
and for how much it forgets. If, for example, you tell the system to store SORT for you, it will al- 
ways be there when you want it; but if you tell the system to delete SORT it will be erased and 
gone forever. If you try to summon it, the system will act as though it has never heard of it. You 
will learn later that you can perform a bit of "black magic' 1 to retrieve these lost files, but we will 
not discuss this in this manual. (For further information refer to the DECsystem-10 Operating Sys- 
tem Commands Manual, the FAILSAFE program.) 

You can use the DECsystem-10 to solve a problem. Your problem will usually be represented as a 
program written in a programming language such as ALGOL, BASIC, or FORTRAN. Before you 
can tell the system to execute your program, you must enter your program into a file. To accom- 
plish this, you are assisted by a program that is called an editor. The name of the editor used in this 
manual is SOS. 

Since you can have more than one file stored within the system, you must decide on a name for 
each of your files. This name will uniquely identify each of your files from one another. 

The name can be anything that you want it to be as long as it is not longer than six characters. The 
extension to that file name usually represents the programming language in which you typed your 
program, but it can be any four characters you wish as long as the first character is always a period. 
You can use one of the following extensions. 
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EXTENSION TYPE OF PROGRAM 

ALG an ALGOL program 

.BAS a BASIC program 

CBL a COBOL program 

FOR a FORTRAN program 

MAC a MACRO program 

NOTE 

If you are using BASIC, you do not have to use the SOS 
editor; you can type a program directly to BASIC. Turn 
to the divider labeled USING BASIC for instructions. 

USING THE SOS EDITOR 

To find the sum of two numbers, we will use two programs: one written in FORTRAN and the 
other in ALGOL; either one solves the problem. You may type the one you choose. If you wish, 
you may try both. 

Whatever your choice of language, you will be using an editor for assistance in typing the program. 
To request the SOS editor's services, type R, a space, and then the command word SOS. Finally, 
press the RETURN key. 

JR_SOSj 

The SOS editor will respond by typing the word FILE followed by a colon. After the colon, type the 
name and extension of your file. Press the RETURN key. 

- R SOS,) 

FILE: PR QG 1 « FOR J 

The SOS editor will type the word INPUT: followed by the name of your file. 

. R SOS J 

FILE: PROG I. FOR J 
INPUT: PROGl.FOR 
00102 
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This line indicates to you that the SOS editor has received your request for assistance, and it is 
ready to start helping you with the file named PROG 1. FOR. 

HINT 

If SOS responds with EDIT: instead of INPUT:, it 
means that you already have a file with that name and 
extension. If this happens, type EQ and press the RE- 
TURN key. Start the edit process over again by typing 
R SOS. This rime when the SOS editor requests the 
name of your file and the file name extension, type in 
a file name different from the one you typed before. 
You can use the same file name extension if you de- 
sire. 

Directly after the SOS editor types INPUT: PROG1 FOR, it will print 00100. For example: 

» R SOS ) 

FILE: PROG! .FOR J 
INPUT: PR0G1.F0R 

00100 

00100 is called a line number. There is a line number for each line of your program starting with 
00100 and increasing by 100 to the end of your program. Line numbers go by hundreds because 
later you may want to insert new lines without altering those lines you have already typed. 

After the SOS editor prints the first line number of your program, type the first line of your pro- 
gram and press the RETURN key. The SOS editor will automatically print the next line number, 
after which you type the next line of your program and press the RETURN key. You should con- 
tinue doing this until you type your entire program. After you type the last line of your program, 
press the ESC key and not the RETURN key. 

Please type the problems exactly as you see them in this manual, check your lines carefully before 
you press the RETURN key. Correct any mistakes by using the RUBOUT key or the CTRL/U 
(you should not retype the line numbers) feature as explained on the previous divider. (Do not 
press CTRL/C). If you make a typing mistake, but you do not discover it until after you have 
pressed the RETURN key, just keep right on typing— we will show you how to correct the mis- 
takes a little bit later. When typing the program below, you can type a tab to space the carriage over 
eight spaces. To type a tab, you press the key labeled CTRL and at the same time press the 1 key. 
This is called typing a CTRL/I which results in a tabulation. 

NOTE 

On some terminals there is a key labeled TAB, which 
is usually on the left side of the keyboard. You can 
press the TAB key to get the same effect as typing a 
CTRL/I 
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Here is a FORTRAN program that solves our addition problem. 



.R SOS 

FILi:: 
INPUT: 

JkJ2 J J 

Jo33 3 

J04d J 

33S3J 
33703 
3353.0 

*esv 

[OSKC: 

• 


PROGl.F 

PROG I . 

1_3.<™> 
® 

L; O (TAB) 

■® 

(TAB' 

3 J vi»g) 
® 

PR OG 1 . F 


FOR 

rOKMAT^CAWriAT^AR^TjiLATWO^MUrUth&TA'^y 


ACC£PTA2u t X, Yj 

rOhMAT^Ciir) J 

AMS*ltR = X+Y J 

TYPiASJ. ANSWcRV 

FORMATAC'aTHt SUMAQF&ThL&NUf'iJc:RS£I3A \ F7.2) J 


' USER PRESSES 

OR ] THE ESC KEY 



If you realize that you have made a typing mistake, turn to page 23 to learn how to correct your 
program. If you are not aware of any mistakes, turn to page 17 to learn how to execute your pro- 
gram. 

Here is an ALGOL program that solves our addition problem. 



. R SOS J 



FILE: 

INPUT: 

03133 

03333 
00430 
30503 
00633 
007C3 
03F33 
309 33 
31303 
31 103 
31233 
31333 
31430 
31533 



PR0G2.ALU J 
PR0G2.ALG 
BEGIN® INTEGER S. 

IThIs ?RogRam wIll 



C t A; 

a5d two 



NUMBERS AND; 



I PRINT THE RESULT; 

15 WRITE&r [2C 3AWHATAARE&THEANUMBERSATQAADD&[ 1C 1A") ; 

~ REAJA(S): 

REA3A(C); 

A:=C+S; 

WRITE&( w [2ClaTHEASUMA0Fa M ): 

PRINTACS.3.3); 

wftirft^aANua"); 

?RINTa(C.3.3): 

wRiTEaraistZr); 



® 

'tab) 
'tab) 
jab) 



'JAB, 

"tmD 



£ND1 



PRINTA(A,3,3) t 
WRITER" [2CW) 



USER PRESSES THE ESC KEY. 



[DSKC:?R0G2.AL3] 
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If you realize that you have made a typing mistake, turn to page 23 to learn how to correct your 
program. !f you are not aware of any mistakes, turn to page 17 to learn how to execute your pro- 
gram. 

CORRECTING TYPING MISTAKES 

Use the RUBOUT key to erase one or more characters in the line you are currently typing. Each 
time you press this key, the last character you typed is erased. The system responds by typing a 
backslash when you press the RUBOUT key for the first time. After the backslash the system will 
print each character that you deleted. When you have finished deleting and you start typing, the 
system will print another backslash. In other words, the system will print a backslash on either side 
of the character(s) you deleted. 

NOTE 

On some terminals, the RUBOUT key may be labeled 
DELETE. 

Consider the following: 




0060k) TYY\Y\ PE 30. ANSWER ^ 



When typing the word TYPE, you hit the Y key twice by mistake. Since you noticed your mistake 
the moment that you made the mistake, you were able to utilize the RUBOUT key, pressing it once 
to delete one character. The system printed a backslash followed by the letter you deleted (which 
was Y). After you typed the P, the system printed another backslash indicating the end of deletion, 
and it printed the character that you just typed. 




00700 PRINT "CQMPUTARS ARE" \"Efffl'SRA\ ERS ARE' 

In line 700, after you typed the second quotation mark, you noticed that you had misspelled the 
word COMPUTERS. You deleted eight characters (a space and a TAB count as one character) by 
pressing the RUBOUT key eight times. The system printed a backslash on either side of the eight 
deleted characters that you deleted. You continued typing the line, before the system printed the 
first character you typed, it printed the second backslash indicating the end of the deletion process. 

You should remember several things when you use the RUBOUT key. First, you cannot correct 
characters on a line once you have pressed the RETURN key. Second, in addition to correcting 
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lines in a program, you can use the RUBOUT key to correct errors you make when typing com- 
mands. For example, if you mistype the LOGIN command, and you notice the error before you hit 
the RETURN key, you can use the RUBOUT key to correct your error. 

NOTE 

If you do not notice your mistake while typing a com- 
mand, and you press the RETURN key, you will usu- 
ally receive an error message. 

. LOGGEN J 
7L0GGEN? 



7LOGGEN? is an error message; the system is tell- 
ing you that it did not understand what you told it to 
do. After the error message, the system prints a period 
after which you can type the correct command. 
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EXECUTING YOUR PROGRAM 

To execute your program, follow the procedure listed below: 

1 . Type the command word EXECUTE after the period prompt character. 

2. Follow the command word EXECUTE with a space, the name of your file, a period, 
and your file's file name extension. 

3. Press the key labeled RETURN. 

If your program did not execute properly and you received an error message, turn to the divider 
labeled EDITING YOUR PROGRAM. Some program errors are caused by typing mistakes. 
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STOPPING YOUR PROGRAM 

To stop your program during its execution, follow the procedure listed below: 

1. Press the key on the terminal keyboard labeled CTRL. 

2. While the key labeled CTRL is in the down position, press the C key twice. 
The above procedure produces a double CTRL/C and stops the execution of your program. 



EXECUTING YOUR PROGRAM 



Now that your program has been typed into a file, it must be translated by the appropriate lan- 
guage translator (compiler) into a machine language program. After this translation, the program 
can be executed. 

Before your program is translated, it is called a source language program, and the file containing it 
has an extension indicating the language in which the program is written (e.g., .FOR indicates a 
FORTRAN program ) After your program is translated, a new file containing the translation of 
your program is created. The name of this file is the same as the name of the untranslated file, but 
this file has an extension of REL (indicating a machine language program.) 

In order to translate and execute your program, type the command word EXECUTE followed by 
the name and extension of your file. Press the RETURN key. 

.EXECUTE filename. extension J 

Note that the extension FOR causes the FORTRAN compiler to translate your program, and 
ALG causes the ALGOL compiler to translate your program. 



EXECUTING YOUR FORTRAN PROGRAM 



. EXECUTE PROGl.FOR J 

FORTRAN: PR0G1 

MAIM.. 

LIM: LOADING 

CLNKXCT PR0G1 EXECUTION] 

WHAT ARE THE TWO NUMBERS? 

23A6789 J 

THE SUM OF THE NUMBERS IS 



FORTRAN translates the file. 
The file is loaded. 

Execution begins. 



6812.00 



END OF EXECUTION 

CPU TIME: 0.09 ELAPSED 

EXIT 



TIME: 11.77 
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EXECUTING YOUR ALGOL PROGRAM 



ALGOL translates the file. 
The file is loaded. 
Execution begins. 



.EXECUTE PRQMiALQJ 
ALGOL! PR0G2 
LINKS LOADING 
[LNKXCT PR0G2 EXECUTION] 



WHAT ARE THE NUMBERS TO ADD 
Ml' 



THE SUM OF 23.0130 AND 345.000 IS: 368.000 

END OF EXECUTION - 2K CORE 
EXECUTION TIME! 0.07 SECS. 
ELAPSED TIME: 14.68 SECS. 



CHECKING YOUR PROGRAM 

If you are curious and want to know how your program is doing, you can check its progress even 
when it is in the middle of execution. To do this, press the CTRL key and, while it is still in the 
down position, press the T key. This process is called typing a CTRL/T. The response from a 
CTRL/T shows the status of your program, the amount of machine time that you have used, and 
the amount of time since you last typed a CTRL/T. 

DAY: :3:56 RUN: 15.61 RD: 1505 WR:250 PR061 2K+5K RN PC:400230 

The response from the CTRL/T indicates that you typed a CTRL/T (which does not produce a 
printed character) while PROG 1 FOR was running. Your program was ki the RUN (RN) state and 
you typed a CTRL/T 3 minutes and 56 seconds earlier. 

Typing a CTRL/T does not interfere with the running of your program in any way. However, if 
your program is typing information on your terminal at the same time that you type a CTRL/T, the 
response from CTRL/T will be mixed in with the information from your program. 



.LQG IN ^ 

JOB 4 R5725D SYS 

#DAY: 0.80 RUN: 0.16 

27 t 4072 j % 

PaSSwORD:J 

1213 21-JAN-75 



#40/2 TTY73 

RD:5 WR:0 LOGIN 



TUE 



2K+11K SL PC: 405365 
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STOPPING YOUR PROGRAM 

Sometimes unexpected things happen in a program, and it may never complete execution. For in- 
stance: 

The program may be written to get information from another file; during its execu- 
tion, however, you remember that the other file does not exist. 

-OR- 

You may decide that you would like to stop the execution of your program because 
you want to do something else. 

No matter what your reason is lor stopping your program, you follow the same procedure: press 
the CTR L key; while it is still in the down position, press the C key twice. You will then see the 
period (.) prompt character which means that your program has stopped execution and that you 
can now type any TOPS- 10 command you wish. 



FOR 



. EXECUTE PROG 1. 

am — loadxW 

[LNKXCT PROGl EtC 
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EDITING YOUR PROGRAM 

STARTING THE SOS EDITOR 

To use the SOS editor in order to change your program, do the following: 

1. After you see the period (.) prompt character, type the letter R, a space, and the com- 
mand word SQS. Press the RETURN key. 

2. After you see the word FILE:, type the name and extension of the file that contains 
the program you want to change. Press the RETURN key. You should see 
EDIT:filename.extension, where filename.extension is the name and extension of 
your file. The name and extension of your file are followed by a period prompt char- 
acter. 

NOTE 

If you see INPUT:filename.ext instead of EDIT: 
filename.ext, press the ESC key. After you see the as- 
terisk (*), type EG and press the RETURN key. 

Check the file name that you typed. If you find that 
you mistyped it, start again at step 1. 

If both the name and the extension were typed cor- 
rectly, perhaps the file has a name different from the 
one you remember; or perhaps the file has been 
deleted. Type the wordDIRECT immediately after the 
period and press the RETURN key. The DIRECT 
command will print on your terminal a list of all of the 
files within your disk area. If your file is not listed, you 
will have to reenter your program into a file. 

After you see the asterisk (*), use any of the commands below to change your file. 

PRINTING A LINE 

To print a line of your file, type P and the number of the line you want to be printed. Press the 
RETURN key. 

* P1300 J 

01300 C = SQRT (A ++2 + 

INSERTING A LINE 

To insert a new line in your file, type the letter I and the line number you want the new line to 
have. Press the RETURN key. After the SOS editor prints a line number, type the new line of your 
program. Press the RETURN key. 

01350 C = SQRT <A**2 + B**2) 



23 



DELETING A LINE 

To delete a line in your file, type the letter D and the number of the line you want deleted. Press 
the RETURN key. 

* D1300 ) 

1 LINES (01300/i) DELETED 



REPLACING A LINE 

To automatically delete a line in your file and insert a new line in its place, type the letter R fol- 
lowed by the number of the line you want to replace. Press the RETURN key. After the SOS Edi- 
tor prints the line number, type the replacement line and press the RETURN key. 

*R 1400 J % 

01400 <^s> THIS LINE HAS BEEN REPLACED ** 

1 LINES (01400/1) DELETED 



CHANGING A LINE 

To replace an existing group of characters within a line with a new group of characters, type the 
letter S and the existing characters; press the ESC key. Type the new characters; press the ESC 
key. Type the number of the line that you are changing; press the RETURN key. 

*P |600 j 

01600 THIS IS A COM COMMENT 

*SACOMa$A$1600 j 

01600 THIS IS A COMMENT 



SAVING THE FILE 

To finish using the SOS editor and save the edited file, type E and press the RETURN key. 

CDSKC: TEST3] 
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EDITING YOUR PROGRAM 

Once you have typed your program into a file, you can use the SOS editor to eliminate any errors in 
it. This section shows you the entire process of editing, re-executing, and typing out a FORTRAN 
program. 

It* you typed either PROG I. FOR or PROG2.ALG incorrectly (and consequently, the program 
would not execute properly), turn to page 27 for directions on editing those errors out of your pro- 
gram. After editing your program to eliminate any errors, type: 

EXECUTE programname.extension^ 



CHANGING YOUR FORTRAN PROGRAM 

If your FORTRAN/ALGOL program is typed correctly, you can change it. Type everything that is 
underlined in the example below to make your program called PROG 1 .FOR add three numbers. 



JR SOS J 



FILE: PRQG1.F0R J 

EDIT; PR0G1.F0R 

* P20fl J 

00200 10 FORMAT C WHAT ARE THE TWO NUMBERS? ' 

*STWO$THREE$200 J 

00200 10 FORMAT C WHAT ARE THE THREE NUMBERS? 

00300 ACCEPT 20, X, Y 

* S,AY$.AY.AZ$300 

00300 ACCEPT 20, X, Y, Z 

* P500 J 

00500 ANSWER=X+Y 

* SY$Y+Z$500 

30500 ANSWER = X+Y+Z 

*&J 

[DSKC:PROG1.FOR[2 7,40 72 ]] 



To see what the changed program looks like, type the following line after the period prompt char- 
acter: 

.TYPE PR0G1 .FOR J 



CHANGING YOUR ALGOL PROGRAM 

Type everything that is underlined in the example below to make your program called 
PROG2.ALG add three numbers. 
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.R SOS J 



FILE: PR0G2.ALG J 
EDIT: PR0G2.ALG 

*P100 j 

00100 BEGIN INTEGER S, C, A; 

* SA$B.AA$100 j 

03100 BEGIN INTEGER S, C, B, A; 

* P233 J 

00200 ITHIS PROGRAM WILL ADD TWO NUMBERS AND: 

* STWOSTHREE$200 ) 

03200 ITHIS PROGRAM WILL ADD THREE NUMBERS AND; 

* I650 j 

00650 <&> READ (3): J 

* P700 ,? 

00700 

* S:S+B;$7flg J 

00700 

*IU50 j 

01150 <® 

♦ 111 60 J 

01 1.60 <® 

*EV 



A: = G+Sj 
At=OSf3; 
WRITE ("AND "): J 
PRINT (a.3.3); J 



Press the "ESC" key. 



[DSKC»PROG2.ALG[27 f 4072 )] 



To see what the changed program looks like, type the following line after the period prompt char- 
acter: 

.TYPE PR0G2.ALQJ 

Now that your changed program is in the file, run it to find any errors. Type EXECUTE and the 
name and extension of the file containing your program; press the RETURN key. 

Note that the extension FOR causes the FORTRAN compiler to translate your program; the ex- 
tension .ALG causes the ALGOL compiler to translate your program. 

If your program did not execute properly because of errors, read the following section for help. If 
your program is exactly like the FORTRAN and/or ALGOL programs in this manual and will not 
execute properly, ask someone familiar with FORTRAN and/or ALGOL to check it over. 



CORRECTING YOUR PROGRAMS 

There may be several typing errors in your program. You can eliminate these errors with the help 
of the SOS editor. 
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STARTING THE SOS EDITOR 

After you see the period prompt character, type R, a space, and the word SOS; press the RETURN 

key. 

. R SOS J 

After you see the word FILE:, type the name of the file to be edited. Follow the file name by a 
period, then by the extension. Press the RETURN key; the SOS editor will print the word EDIT: 
followed by the file name and extension; and on the next line it will print an asterisk. For this 
example, we are using the file name PROG2 with the extension AL(i 

. ft SOS J 

FILE: PR0G2.ALG J 
EDIT: PK0G2.ALG 
* 

NOTE 

If you see INPUT: instead of EDIT:, press the ESC 
key After you see the asterisk (*), type EQ and press 
the RETURN key. 

Check the name and extension that you typed. If ei- 
ther was mistyped, you can start the procedure at step 
1. 

If neither the name nor the extension was mistyped, 
perhaps the file has a name different from the name 
you remember; or perhaps the file had been deleted. 

Type the word DIRECT immediately after the period 
and press the RETURN key. The DIRECT command 

will list the names of the files within your disk area. If 
your file is not listed, you will have to retype your pro- 
gram into a file. 

After you see the asterisk, you can use any of the following commands to edit your file. 



PRINTING A LINE 

Print the line in which you think that there is an error. To print a line, type the letter P directly 
after the asterisk prompt character followed by the number of the line you want printed. Press the 
RETURN key. The command P1300 prints the contents of the line numbered 1300. 

* P1300 j 

01300 BEGIN INTEGER S f C; 

In line number 100, the integer A was omitted between the comma and the semicolon. 

To print a group of lines, type the letter P directly after the asterisk prompt character. Follow the 
letter P with the number of the first line to be printed, a colon, and the number of the last line to 
be printed. Press the RETURN key. The command P500: 700 prints the lines 500 through 700. 
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*P500t700 j 

00500 RED (S); 

00600 READ READER (C); 

00700 A := C + Cj 

We see several errors: an A has to be inserted into line number 500; in line number 700 the sec- 
ond C must be changed to an S; line number 600 has two READs. Refer to the section CHANG- 
ING A LINE to correct the error in line 500. Refer to the section REPLACING A LINE to correct 
the error in line numbered 600. Refer to the next section, INSERTING A LINE, to correct the 
error in line number 700. 



INSERTING A LINE 

To insert a line into your file, type the letter I followed by the number of the line you want to in- 
sert. Press the key labeled RETURN. The command inserts the line 750. After SOS types the new 
line number, type the line to be inserted; press the key labeled RETURN. 

010750 At: C ♦ S| 

Under some circumstances SOS types another line number after you press the key labeled RE- 
TURN. When this happens, press the key labeled ESC; SOS will then print an asterisk. 



DELETING A LINE 

Line 700 should now be removed from your file, since line number 750 has been inserted into the 
file. To delete a line in your file, type the letter D followed by the line number of the line you wish 
to be deleted. Press the key labeled RETURN. The command D700 will delete line number 700 
from your file. 

* D700 j 

1 LINES (00700/i) DELETED 



REPLACING A LINE 

In line 600, our error was typing READ twice. The R (for replace) command deletes the line and 
automatically accepts text for replacement. 

To replace a line within your file, type the letter R followed by the number of the line you want to 
replace. Press the key labeled RETURN. After SOS types the line number, type the new contents 
of the line and press the key labeled RETURN. The command R600 replaces the line 600. 

»R60g J 

0060? READ CO; 

1 LINES (00600/1) DELETED 
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CHANGING A LINE 

In line number 500, the letter A has to be inserted between the letters E and D. To replace existing 
characters within a line with a new group of characters — (l)Type the letter S followed by the char- 
acters you wish to be replaced; (2)Press the ESC key; (3)Type the replacement characters; 
(4)Press the ESC key; (5)Type the number of the line that you want to change; (6)Press the RE- 
TURN key. The command SEDSEADS500 replaces the existing characters ED within line 500 
with new characters E AD. 



* P5®d J 
00500 

* SEDJEAD$500 j 
00500 



RED (S); 
READ (S); 



SAVING THE FILE 

To finish using the SOS editor and to save the edited version of the file, type the letter E and press 
the RETURN key. 



CDSKC: TESTS ] 



The system types the name of your 
file. 



RE-EXECUTING YOUR PROGRAMS 



To execute your FORTRAN program a second time, follow the example below. 



.EXECUTE 


PR0G1.F0RJ 




FORTRAN: 


PROGi 




(WIN. 






LI NK: 


LOA DI NG 




CLNKXCT J 


3 R0G1 EXECUTION] 




WHAT ARE 


THE THREE NUMBERS? 




2344567J 






3A5J 






THE SUM 


OF THE NUMBERS IS 1146 


• 00 


END OF EXECUTION 




CPU TIME: 


0.09 ELAPSED TIME: 


16.22 


EXIT 







To execute your ALGOL program a second time, see the following example. 
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. EXECUTE PR0G2.ALG J 
ALGOL: PR0G2 
LINKS LOADING 
[LNKXCT PR0G2 EXECUTION] 



WHAT ARE THE NUMBERS TO ADD 
WSJ 



THE SUM OF 2345.00)3 AND 654.003AND 


3456.000 IS: 


6455.000 


END OF EXECUTION - 2K CORE 






EXECUTION TIME: 0.08 SECS. 






ELAPSED TIME: 16.62 SECS. 







Type two CTRL/Cs to stop the execution of your program. 



TYPING OUT YOUR PROGRAM 



To get a final copy of your FORTRAN program, type the word TYPE after the period prompt 
character. Follow the word TYPE with one space, followed by the file name and extension of your 
program. Press the RETURN key. 



.TYPE 


PROGl 


.FOR J 


00100 




TYPE 10 


00200 


10 


FORMAT C WHAT ARE THE THREE NUMBERS? f ) 


00300 




ACCEPT 20, X, Y, Z 


00400 


20 


FORMAT (2F) 


00500 




ANSWER = X+Y+Z 


00600 




TYPE 30, ANSWER 


03700 


30 


FORMAT C THE SUM OF THE NUMBERS IS \F7.2) 


00800 




END 
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.TYPE 


PR0G2.ALG J 




001 00 


BEGIN 


INTEGER S, C t 3, A; 




00200 


ITHIS 


PROGRAM WILL ADD THREE NUMBERS AND; 




003 00 


! PRINT 


THE RESULT; 




00400 




WRITE (T2C) WHAT ARE THE NUMBERS TO ADD [1C] 


"); 


00500 




READ (S); 




00600 




READ (C); 




00650 




READ (3); 




00700 




Aj=C+S>-3; 




30800 




WRITE <"[2C) THE SUM OF "); 




00900 




PRINT (3,3,3); 




01000 




WRITE < w AND "); 




01100 




PRINT (C,3,3); 




01150 




WRITE ("AND "); 




01160 




PRINT (3,3,3); 




01200 




WRITE (" IS: "); 




01500 




PRINT (A,3,3); 




01400 




WRITE Ct2C] w ); 




01500 


END 
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WORKING WITH FILES 



LISTING THE NAMES OF YOUR FILES 

To obtain a list of your file names, do the following: 

1. After you see the period prompt character, type the word DIRECT and press the key 
labeled RETURN. 

The names of each file, along with some other information, is printed on your terminal. The fol- 
lowing example is typical of a TOPS- 10 response to a direct command. 



.DIRECT^ 








PR0G1 REL 


2 <055> 


21-JAN-75 


DSKC: [27,4072] 


TEST1 


1 <055> 


21-JAN-75 




TEST2 


1 <055> 


21-JAN-75 




PR OG 1 FOR 


1 <055> 


21-JAN-75 




PR0G2 ALG 


1 <055> 


21-JAN-75 




PR0G2 REL 


2 <055> 


21 -J AN- 75 




TOTAL OF 8 

• 


BLOCKS IN 6 


FILES ON DSKC: 


[27,4072] 



DELETING A FILE 

To remove a file that you no longer want in your disk area, do the following: 

1. After the period prompt character, type the word DELETE. Type a space followed by 
the name of the file you wish to delete. Press the RETURN key. 

The system will print the name(s) of the file(s) it deleted and the number of blocks in your direc- 
tory which were freed by this deletion. The following example is typical of a TOPS- 10 response to a 
DELETE command. 



. DELETE TEST1 J 

FILES DELETED: 

TEST1 

01 BLOCKS FREED 
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GETTING HELP FROM TOPS-10 

To have the system help you with programs follow the procedure below: 

1. Type the word HELP after the period prompt character. 

2. Type a space followed by an asterisk (*). 

3. Press the RETURN key. 

The system will print a list of all program names with which it can help you. Look down the list, 
find the program with which you want help, and follow the procedure below. 

1. Type the word HELP followed by a space. 

2. Type the program name with which you want help. 

3. Press the key labeled RETURN. 

COPYING ANOTHER USER'S FILE 

You can copy a file from another user's directory into your directory by following the procedure 
below: 

1 . Type the word COPY followed by a space. 

2. Type the file name and extension of the file which will be put into your area (the 
destination file.) 

3. Type an equal sign. 

4. Type the file name and extension of the other user's file. 

5. Type a space followed by the other user's project-programmer number in square 
brackets. 

6. Press the RETURN key. 

RUNNING ANOTHER USER'S PROGRAM 

To execute a program which resides in another user's directory area, follow the procedure below. 

1. Type the word RUN followed by a space. 

2. Type the name and extension of the other user's file. 

3. Type the other user's project-programmer number in square brackets. 

4. Press the key labeled RETURN. 
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WORKING WITH FILES 



You have an area on the disk that is uniquely yours - a space reserved for the storage of your files. 
Identified by your project-programmer number, this area is known as your directory, and it con- 
tains all the information about the files you create. 



LISTING THE NAMES OF YOUR FILES 

Now that your programs have been entered into the computer and executed, you have four files in 
your disk area. To obtain a listing of these file names, type the word DIRECT immediately follow- 
ing the period prompt character; press the key labeled RETURN. 



.DIRECT J 








PR0G1 REL 


2 <055» 


21-JAN-75 


DSKC: [27,4072] 


TEST2 


1 <055> 


21 -J AN- 75 




PR0G1 FOR 


1 <055> 


21-JAN-75 




PR0G2 ALG 


1 «055> 


21 -J AN- 75 




PR0G2 REL 


2 <055> 


21 -JAN- 75 




TOTAL OF 7 

• 


BLOCKS IN 5 


FILES ON DSKC: 


[27,4072 ] 



When you edit your file for the first time, SOS changes your original, unedited file into a backup 
file. In this change process, SOS will change the file's extension to Qxx, where xx are the last two 
letters of the file's original extension. SOS creates this backup file so that you will always have an 
unaltered copy of your original file. 

The DIRECT command output also includes the number of blocks occupied by the file, and its 
creation date. In the upper-right corner of the printout, you will find the name of the disk storing 
your files along with your project-programmer number. 



DELETING A FILE 

If there is a file in your directory that you no longer need, you may delete it. To delete one or more 
files you use the DELETE command. For example, to delete the file called TEST2, you can issue 
the following command: 



. DELETE TEST2 J 

FILES DELETED: 

TEST2 

01 BLOCKS FREED 
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The system types the words FILES DELETED: in response to the DELETE command, and it then 
lists the name(s) of the file(s) it deletes from your area. The system prints a line telling you how 
many blocks were freed in your directory because of this deletion. 

When the .DIRECT command is issued again, you can see that TEST2 has been deleted from your 
directory. 



.DIRECT^ 








PROG I REL 


2 *055> 


21-JAN-75 


DSKCt [27,4072] 


PR0G1 FOR 


1 «055> 


21-JAN-75 




PR0G2 ALG 


1 «055> 


21-JAN-75 




PR0G2 REL 


2 <055> 


2 1 -J AN- 75 




TOTAL OF 6 

• 


BLOCKS IN 4 


FILES ON DSKCt 


(27,4072] 



GETTING HELP FROM TOPS-10 

The system can print out a list of various data which can help you in your programming tasks. You 
can have this information printed by using the HELP command. To get a list of the available sub- 
jects with which TOPS-10 can help you, type the command word HELP, a space, and an asterisk 
after the period prompt character. 



.HELP *) 








HELP IS AVAILABLE FOR THE FOLLOWING! 








ALCOMP ALLOT ALQUIK BACKUP BASIC 


BLIS10 


BOOTH 


BOOTGT 


BSC CDPSPL CDRSTK CHANGE C0300T 


COBOL 


COBRG 


CREDIR 


CREF DDT DELFIL DIRECT DISMOU 


DSKRAT 


FAILSA 


JEREM — 


FILCOM FILE FORDDT FORTRA FRS 


FUDGE 


^QASiP-- - * 




GRIPE HELP INI I NJIBA- J c *»■*-- 


— ATU.- -—■** 






LINK LOGIN LPGO'i*-"""* • 

• 
• 









The system will print a list of all the programs with which it can help you. Find on this list the 
program on which you would like assistance, then type: 

HELP name J 

where name is the command or program name you have chosen from the list typed by the HELP * 
command. 
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.HELP LOGIN J 
















COMMAND FORMAT: 
















LOGIN PROJ t PROG 


/SWITCH/SWITCH 










WHERE SWITCHES 


ARE: 














CORE: N 




SET THE 


CORE 


LIMIT TO N 


K. 






DSKFUL: PAUSE 




PRINT A MESSA 
WHEN THE DHSK 


3E AND ALLOW A 
GETS FULL. 


CONTINUE 


DSKFUL: ERROR 




IF THE 
PROGRAM 


DISK 

AN OU 


FILL UP 
TPUT ERROR, 


GI VE THE 
(DEFAULT) 


USER 


DSKPRI: N 




SET THE 


DISK 


PRIORITY TO 


N. NtO 







COPYING ANOTHER USER'S FILE 

You can copy one of your files into another file in your area. You do this by typing the command 
word COPY, the name of the new file, an equal sign, and the name of the file being copied. 

.COPY NEW = OLD J 



You can also copy a file from another user's directory into your own. You do this by typing the 
command word COPY, the name of the file to be in your area, an equal sign, the name of the other 
user's file, and his project-programmer number. 

. COPY MINE = GRADES .F0H{Z7 9 A\d2d) J 



Some of the files cannot be copied; if this is the case, you will receive an error message. 



RENAMING A FILE 

You can rename any file in your directory. You do this by typing the command RENAME fol- 
lowed by the new file name, an equal sign, and the old file name. 
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.RENAME TESTER = MI NE J 

FILES RENAMED! 

MINE 



RUNNING ANOTHER USER'S PROGRAM 

You can execute a program that resides in another user's directory area. You can do this by typing 
the line: 

RUN progname [ppnj 

where progname is the file name and Hie name extension of the other user's program. Ippn] is the 
other user's project-programmer number. 
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USING BASIC 

If you want to run a BASIC program, you can enter it directly to BASIC; you do not have to use 
any Editor. 

STARTING BASIC 

After you see the period prompt character, type R BASIC and press the RETURN key. 

. R BASIC J 

READY, FOR HELP TYPE HELP. 

ENTERING YOUR PROGRAM 

If you want to enter a new BASIC program, do the following: 

1. After you see the words READY, FOR HELP TYPE HELP, type the command 
word NEW and press the RETURN key. 

2. After you see the words 

NEW FILE NAME-- 
type a name for your program and press the RETURN key. 

3. After you see the word READY, begin typing in your program. Start each line with a 
line number, type the contents of the line, and press the RETURN key at the end of 
each line. 

NEW J 

NEW FILE NAME— ADDl.BAS J 

READY 

SAVING YOUR PROGRAM 

Once you have finished entering your program, type the word SAVE and press the RETURN key. 

SAVE ,) 
READY 

RUNNING YOUR PROGRAM 

To run your program, type the word RUN and press the RETURN key. 

READY 
RUN J 

ADD1 11:51 24- J AN- 75 



TIME: 0.23 SECS. 
READY 
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EDITING YOUR PROGRAM 

To edit your BASIC program, type the number of the line you want to change. Then type the new 
contents of that line and press the RETURN key. 

260 INPUT J 
355 PRINT J 

REPLACING YOUR PROGRAM 

After you have finished editing your program, type the word REPLACE and press the RETURN 
key. 

REPLACE J 

READY 

LISTING YOUR PROGRAM 

To list the entire program, type the word LIST and press the RETURN key. 

LIST j 

RUNNING AN EXISTING PROGRAM 

If you want to run an existing program, do the following: 

1. After you see the word READY, type the word OLD, a space, and the name of the 
existing BASIC program. Press the RETURN key. 

2. After you see the word READY, type the word RUN and press the RETURN key. 

OLD NAME.BAs J 

READY 
RUN J 

LEAVING BASIC AND LOGGING OFF 

To leave BASIC and log off the system, type the word BYE and press the RETURN key. 

JOB" 4, USER [27,4072] LOGGED OFF TTY73 1318 21-JAN-75 

SAVED ALL FILES (80 BLOCKS) 
RUNTIME 51 .87 SEC 

TO RETURN TO MONITOR MODE 

To return control to the Monitor, type the command MON and press the RETURN key: 

M0N*> 
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USING BASIC 

If you want to enter and execute a BASIC program, you can type in your program directly to 
BASIC; you do not have to use any special editor as BASIC has a built-in editor. The following 
sections describe how to enter a BASIC program, execute it, and edit it. 

STARTING BASIC 

After you see the period prompt character, type the letter R followed by a space. Type the wofd 
BASIC and press the key labeled RETURN. 

.R BASIC J 



READY, FOR HELP TYPE HELP. 

Once BASIC types the message, READY, FOR HELP TYPE HELP, you may use any of the 
BASIC commands discussed in this section. You may not, however, use any of the TOPS-10 com- 
mands. When you give the R BASIC command, TOPS-10 turns you over completely to BASIC. 

You can interrupt BASIC in one of two ways. You can type the word MON which is a BASIC com- 
mand that will return you to TOPS-10 or you can type the BASIC command BYE which logs you 
off the system, so that you have to log in all over again. 

ENTERING YOUR PROGRAM 

After BASIC types the words READY, FOR HELP TYPE HELP, you are ready to enter your file, 
type the word NEW which will indicate to BASIC that you are going to enter a new file in the com- 
puter. Press the RETURN key. 

•R BASIC J 



READY, FOR HELP TYPE HELP. 

new J 

BASIC will type on your terminal NEW FILE NAME--, after which you should type the name of 
your new file. Press the RETURN key. 

NEW FILE NAME— AD Dl. HAS J 

BASIC will type READY signifying to you that it is ready for you to start entering your file into the 
computer. 

READY 

When you are entering your program into a file, precede every line of your program with a line 
number. Press the RETURN key at the end of every line. 

Below is a BASIC program that adds two numbers. Type the program exactly as we have typed it 
here. If you make a mistake after you hit the RETURN key, just keep right on typing; we will 
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show you how to correct those mistakes a little later. If you make a mistake in a line but you notice 
it before you press the RETURN key, you can use the RUBOUT key. 



Ji BASICS 


READY, FOR HELP TYPE HELP. 

NEW J 

HZ4 FILE NAME— ADDl.iiAS J 


REAJY 
130 <3) 

110 ® 
120 ® 


PRI NTA"WHAT^REATREATW0&NUM3ERS" J 


?RINTA w THATAYOUAWANTATQAADD?" J 


INPUTAA J 


130 <S3> 


INPU1&B J 


140 ® 


LET6C = A+3J 


153 ® 


PRINTA M THE6ANSWER&IS:A M J 


1S3 <S> 


PRIMTACj 


170 <@ 
180 (% 


PRI Nla"D DAY OUAWANTATO^ADaaA MOTH ERA" ) 


PRI NTA ,, ASET40FAN^JMBERS7 ,, J 


193 <g> 

203 <S> 


PRI NTA M TY?2A1AF0RAYES SATYPEA06FORANO." J 


INPUTS J 


213 <@> 


IF&J = lAu0T0A133 J 


223 <3> 


PRI NTA"SEE6Y0UALAT EH ." J 


225 <3> 


STOP J 


233 ® 


END J 



Check your program over at this time: have you made any typing mistakes within your program? 
If you have, turn to the section EDITING YOUR PROGRAM before you do anything else. If you 
have not made any typing errors, you can execute your program. Before you can execute a BASIC 
program you should SAVE that program. 
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SAVING YOUR PROGRAM 

Once you have finished entering your program into the computer, type the word SAVE and press 
the RETURN key. BASIC will print the word READY as soon as it has finished SAVing your pro- 
gram. If you do not save your BASIC program BASIC will not save it in your disk area, and it can- 
not be executed. So always remember to save your programs immediately after you type them into 
a file. The visible results of the SAVing procedure are as follows (what you type is underlined): 



SAVE*) 



READY 



RUNNING YOUR PROGRAM 

To run (execute) the program that you entered into the computer, type the word RUN and press 
the RETURN key. BASIC will then type the name of your program, along with the current time 
and date. As soon as you see the word READY typed on your terminal, BASIC has finished exe- 
cuting your program. 



RUN^ 




ADD1 13:03 


21 -JAN- 75 


WHAT ARE THE TWO NUMBERS 




THAT YOU WANT TO ADO? 




?23j 
7456J 




THE ANSWER IS: 




479 




DO YOU WANT TO ADD ANOTHER 




SET OF NUMBERS? 




TYPE 1 FOR YES; TYPE FOR 


NO. 


?1J 




WHAT ARE THE TWO NUMBERS 




THAT YOU WANT TO ADD? 




77654^ 




7987J 




THE ANSWER IS: 




8641 




DO YOU 'WANT TO ADD ANOTHER 




SET Or NUMBERS? 




TYPE 1 FOR YES; TYPE FOR 


NO. 


?0 J 




SEE YOU LATER. 




TIME: 0.41 SECS. 




READY 
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BASIC executed the program named ADD1.BAS. Everything that appeared on your terminal be- 
tween the current date that BASIC typed and the word TIME: was a part of your program. Every- 
thing that BASIC typed between those two lines were lines that you told it to type within the pro- 
gram. 

EDITING YOUR PROGRAM 

Check your program over. If you have any typing mistakes, retype the erroneous lines correctly, 
repeating their numbers also. When you finish correcting these lines, replace the unedited pro- 
gram with the one you have just edited by typing the BASIC command word REPLACE, then a 
carriage return (which is performed by pressing the RETURN key.) 

There are other reasons for editing a program; you may, for example, wish to make your program 
add three instead of only two numbers. The following procedure will make this change: 



100 @> PRI NftTWHATaAREaTHEATHREEANUMaERS" J 

135 <® INPUTAE J 

140 <S> LETAC = A ♦ B + E J 



REPLACING YOUR PROGRAM 

After you have finished editing your program, type the word REPLACE and PRESS THE RE- 
TURN key. BASIC will print the word READY when it has replaced the unedited program with 
the edited program. 



REPLACE J 
READY 
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RE-RUNNING YOUR PROGRAM 

Whether you have fixed your program or changed it, run it to find out if it works. 



ADD1 



13; A3 



21 -JAN- 75 



WHAT ARE THE THREE NUM3ERS 
THAT YOU WANT TO ADD? 

THE ANSWER IS: 

2924 
DO YOU WANT TO ADD ANOTHER 

SET OF NUMBERS? 
TYPE 1 FOR YES; TYPE FOR NO, 

?£ J 
SEE YOU LATER. 



TIME: 0.28 SECS. 
READY 
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LISTING YOUR PROGRAM 

Get a final copy of your corrected program. To list the entire program in your working area, type 
the word LIST and press the key on the terminal labeled RETURN. 



LIST J 




ADD1 


13:05 21-JAN-75 


100 


PRINT -WHAT ARE THE THREE NUMBERS" 


110 


PRINT "THAT YOU WANT TO ADD?" 


120 


INPUT A 


130 


INPUT 8 


135 


INPUT E 


140 


LET C : A + 3 + E 


150 


PRINT "THE ANSWER IS: " 


160 


PRINT C 


170 


PRINT "DO YOU WANT TO ADD ANOTHER " 


180 


PRINT " SET OF NUMBERS?" 


190 


PRINT "TYPE 1 FOR YES; TYPE FOR NO." 


200 


INPUT D 


210 


IF D : 1 GOTO 100 


220 


PRINT "SEE YOU LATER." 


225 


STOP 


230 


END 


READY 





To list a single line of your program, type the word LIST, followed by a space, followed by the num- 
ber of the line that you wish to be printed. 

LIST line-no. J 

Press the key on the terminal labeled RETURN. 

LIST 130J 



ADD1 



13:06 



21-JAN-75 



130 
READY 



INPUT B 
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RUNNING AN EXISTING PROGRAM 

To run an existing program you must do two things. First, you must move a copy of the program 
you want from your storage area into your working area. Then, you must type the word RUN and 
press the key labeled RETURN. 

To move a copy of an existing program from your storage area to your working area, type the word 
OLD, a space, and the name of the program that you want to execute. Press the key on the terminal 
labeled RETURN. 

OLD filename J 

Here is an example of the execution of an existing program: 

READY 
RUlO 

MAME 13:16 21-JAN-75 



WHAT IS YOUR NAME? 

? SCOTT ^ 
SCOTT 



TIME: 0.09 SECS. 
READY 

LEAVING BASIC AND LOGGING OUT 

To leave BASIC and log out, type the word BYE and press the key on the terminal labeled 
RETURN. 

Here is an example of logging out in BASIC: 

JOB 1 7, USER [27,4072] LOGGED OFF TTY73 1152 24-JAN-75 

SAVED ALL FILES <9<5 dLOCKS) 
RUNTIME 2.3 7 S*£C 
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APPENDIX 
TOPS10 COMMANDS 



This appendix lists and briefly describes all commands in the TOPS- 10 Command Language. Al- 
though most of these commands have not been described within this manual, the purpose of their 
inclusion in this appendix is to make you aware of the full extent and capability of the TOPS-10 
Command Language. The DECsystem-10 Operating System Commands Manual describes all of 
these commands in detail. 



COMMAND 



MEANING 



ASSIGN 
ATTACH 

BACKSPACE 

CCONTINUE 

CLOSE 

COMPILE 

CONTINUE 

COPY 

CPUNCH 

CREATE 

CREF 

CSTART 

D(deposit) 
DAYTIME 

DCORE 
DDT 



Allocate an I/O device to a specified job. 

Detach the current job and connect the terminal to a de- 
tached job. 

Space a magnetic tape backwards a specified number of 
flies or physical records. 

Continue a program from the point at which it was inter- 
rupted; leave the terminal in monitor mode. 

Close all files, preserve logical names and device assign- 
ments, and terminate any current I/O. 

Produce a relocatable binary (.RED file for a specified 
source file. 

Continue a program from the point at which it was inter- 
rupted. 

Transfer a file from one I/O device to another. 

Place entries into the card punch output device. 

Open a file for creation and invoke the LINE EDITOR 
(LINED). 

Invoke CREF to list on the line printer any cross-refer- 
enced files generated by a previous COMPILE, LOAD, 
EXECUTE or DEBUG command. 

Begin execution of a program which was either previ- 
ously loaded with the GET command or interrupted 
while running; leave the terminal in monitor mode. 

Deposit information in the user's core area. 

Type the current date followed by the current time of 
day. 

Invoke DAEMON to write a core-image of the user's 
area; this file includes all accumulators and relevant job 
tables. 

Load the user program; start the program using DDT. 
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COMMAND 

DEASSIGN 

DEBUG 

DELETE 
DETACH 

DIRECT 
DISMOUNT 

DSK 
DUMP 

E(examine) 

EDIT 

EOF 
EXECUTE 

FILE 

FINISH 

FUDGE 

GET • 

HALT 

HELP 
INITIA 



MEANING 

Deassign devices currently ASSIGNed, return these de- 
vices to the monitor's poo! of available devices and clear 
any logical names associated with these devices. 

Translate a source program; load DDT followed by the 
user's program with local symbols. Transfer of control is 
given to DDT. 

Delete one or more files from disk or DECtape. 

Disconnect the terminal from the user's job without af- 
fecting the status of the job. 

List all directory entries. 

Return a device to the monitor's pool of available devices 
and remove a file structure from the job search list. 

Type the disk usage for the combined structures of the 
job both since the last DSK command was issued and 
since the job was initiated. 

Invoke DAEMON to write a core image file; invoke 
DUMP to analyze the file written and to provide print- 
able output. 

Examine a core location in the user's core area (high or 
low segment). 

Open an already existing line-numbered file on disk for 
editing with the Line Editor (LINED). 

Write an end-of-file mark on the specified mag tape. 

Translate a source file, load the generated .REL file, and 
begin execution. 

Provide remote control of DECtape-to-disk and disk-to- 
DECtape transfers on operator-handled DECtapes. 

Terminate any I/O currently in progress on a specified 
device; close the file; release the device; DEASSIGN the 
device. 

Create a library .REL file from a temporary file generated 
by a previous COMPILE. EXECUTE, or DEBUG com- 
mand string containing the /FUDGE switch. 

Load a core image file from a retrievable storage device; 
execution will not begin automatically. 

Stop the current job and store the place where interrup- 
tion occurred in the job data area. 

Type useful information about various system features. 

Perform standard system initialization for a terminal. 
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COMMAND 



MEANING 



JCONTINUE 
KJOB 
LABEL 
LIST 

LOAD 

LOCATE 
LOGIN 

MAKE 

MOUNT 
PJOB 

PLEASE 

PLOT 
PRESERVE 

PRINT 
PROTECT 

QUEUE 
R 

R ALCFIL 

R DTCOPY 



Continue a job that was stopped because of a CTRL/C. 

Kill the current job. 

Write an identifier onto a DECtape. 

Invoke PIP to list the contents of a named source file on 
the line printer. 

Translate the specified source file; invoke the linking 
loader and load the .REL file generated. 

Establish the user's job at a specified remote station. 

Establish the user's authority to gain access to the sys- 
tem. 

Create a new file on disk with TECO (text Editor and 
Corrector.) 

Request assignment of a device via the operator. 

Type the job number to which the user's terminal is at- 
tached. 

Allow two-way communication between a user and the 
designated station operator. 

Place entries in the plotter queue. 

Preserve the specified files with the standard protection 
code (either 055 or 057) inclusively ORed with 100. 

Place entries into the line printer queue. 

Alter the access protection codes associated with the 
specified file. 

Make an entry in a system queue. 

Load a core image file from a system device and start the 
file. 

Allocate space for a new file or reallocate space for an ex- 
isting file in one contiguous region on the disk. 

Invoke the DTCOPY routine which will: 

1. Copy the entire contents of an input DECtape to an 
output DECtape. 

2. Zero all blocks on an output DECtape and clear the 
directory. 

3. Perform a word-by-word comparison of two DEC- 
tapes. 

4. Load a bootstrap loader and write it in blocks 0, 1, and 
2 of the output DECtape. 
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COMMAND 

RDUMP 
R FAILSAFE 
R FILCOM 
R FILEX 

R FUDGE2 

R GLOB 



R GRIPE 



ROPSER 



R QUOLST 

R REATTA 
R SETSRC 



REASSIGN 



MEANING 

Provide printable dumps of arbitrary data files in a mode 
form specified by the user. 

Save disk files on magnetic tape and place all or some of 
these saved files back onto the disk. 

Compare two versions of a file and output any differ- 
ences. 

Transfer files and convert between one core image for- 
mat to another core image format. Read and write various 
DECtape formats. 

Update files containing one or more relocatable binary 
modules and manipulate the individual modules within 
these files. 

Read multiple binary files and produce an alphabetical 
cross-referenced list of all global symbols (symbols ac- 
cessible to other programs) encountered. The GLOB pro- 
gram also searches files in library search mode, checking 
for global symbols, if the program file was loaded by 
LINK-10 in library search mode. 

Invoke the GRIPE program which accepts text from a 
user and records it into a disk file, thereby enabling users 
to record comments and complaints to be read at a later 
time by the operating staff. 

Invoke the OPSER program which is used to facilitate 
multiple job control from a single operator terminal by al- 
lowing the operator to run several jobs called subjobs 
from his terminal. The OPSER program acts as the super- 
visor of the various subjobs by allowing monitor level or 
user level commands to be passed to all of the subjobs or 
to selected subjobs. 

Invoke the QUOLST program which informs the user of 
both the amount of disk space he has used and the 
amount he has left on each file structure in his search list. 

Invoke the REATTA program which allows a user to 
transfer his job from one terminal to another. 

Invoke the SETSRC program which manipulates the 
job's search list of the system's search list. A search list is 
defined to be the order of file structures that are to be 
searched whenever generic device DSK: is explicitly or 
implicitly specified by the user. The user can alter the 
search list defined for him by adding or deleting struc- 
tures from it by using the SETSRC program. 

Allow one job to pass a device to a second job without 
having the device go through the monitor device pool. 
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COMMAND 

REENTER 

RENAME 
RESOURCES 

REWIND 
RUN 

SAVE 

SCHED 

SEND 



SET BLOCKSIZE 
SET BREAK 

SET CDR 

SET CPU 

SET DENSITY 
SET DSKFUL 



SET DSKPRI 
SETHPQ 



MEANING 

Copy the saved program counter value from .JBPC into 
JBOPC and start the program at an alternate entry point 
specified in JBREN, JBREN must be set by the user or 
by the user's program. 

Change the name of one or more files on disk or DEC- 
tape. 

Print the names of all available devices (except TTY's 
and PTY's), all file structures, and all physical units not 
in file structures (unless they are down or non-existent.) 

Rewind a magnetic tape or a DECtape. 

Load a core image from a retrievable storage device and 
start at the location specified within the file (location 
.JBSA in the job data area location.) 

Write out a core image of the user's core area on the spec- 
ified device. 

Type out the schedule bits as set by the last privileged 
SET SCHED command. 

Provide a mechanism for one-way interconsole commu- 
nication. A line of information is transmitted from one 
terminal to another, with the identification of the termi- 
nal sending the information. With remote communica- 
tions capabilities, SEND is able to differentiate stations. 

Set a default blocksize for the specified magnetic tape. 

Set a break address which will cause a break condition 
when the specified address is read from, written into, 
and/or fetched. (Kl-lOand KL-10 processors only.) 

Set the filename for the next card-reader spooling inter- 
cept. 

Allow a privileged user to change the CPUs on which his 
job can run. 

Set a default density for the specified magnetic tape. 

Control the treatment of a user's job when it is attempt- 
ing output when one of two conditions occur. One condi- 
tion is when there is no available space on the file struc- 
ture being referenced; the other condition is when the 
user's quota for that file structure has been exceeded. 

Allow a privileged user to set the priority for his job's disk 
operations. 

Allow a privileged user to place his job in a high-priority 
run queue. 
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COMMAND 



MEANING 



SET PHYSICAL LIMIT 

SET PHYSICAL GUIDELINE 

SET SPOOL 

SET TIME 
SETTTY 



SET VIRTUAL LIMIT 
SET WATCH 

SKIP 
SSAVE 

START 

SUBMIT 
SYSTAT 

TECO 
TIME 



TPUNCH 
TTY 

TYPE 



Set a physical user maximum physical page limit. 

Set a maximum physical page guideline. 

Add devices or delete from the current list of devices be- 
ing spooled for this job. 

Set a central processor time limit for a job. 

Declare properties of the terminal line on which the com- 
mand is typed to the scanner service. With hardwired 
TTY's the system manager can set the default conditions, 
so that this command is usually not needed. However, 
the user is likely to use this command on data sets, where 
the terminal properties cannot be predicted. 

Set a user virtual page limit. 

Set the system to print incremental job statistics automat- 
ically. This command provides the user with a tool for 
measuring the performance of a specified program. 

Space a magnetic tape forward a specified number of files 
or records or to the logical end of the tape. 

This command is the same as the SAVE command ex- 
cept that the high segment if present, will be sharable 
when it is loaded with the GET command. 

Begin execution of a program either previously loaded 
with the GET command or interrupted (i.e., with a 
CTRL/C). 

Place entries into the input queue for the Batch system. 

Run a system program which prints status information 
about the system. This information allows a user to deter- 
mine the load on the system before logging-in. 

Invoke TECO (Text Editor) and open an already existent 
file on disk for editing. 

Type the total running time since the last TIME com- 
mand, followed by the total running time used by the job 
since it was initialized (logged-in), followed by the inte- 
grated product of running time and core size (KILO- 
TORE-SEC-). 

lace entries into the paper-tape punch output queue. 

Declare properties of a terminal (see SET TTY com- 
mand.) 

Direct PIP to type the contents of the named source 
file(s) on the user's terminal. 
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COMMAND 



MEANING 



UNLOAD 
USESTAT 

VERSION 
WHERE 



ZERO 



Rewind and unload a magnetic tape or a DECtape. 

Return status information pertinent to the current user. 
(Identical to a CTRL/T). 

Print the version number of the program in the user's 
core area (i.e., the last program run implicitly or expli 
citly.) 

Enable the user to determine the station at which a spe- 
cific peripheral device is located. If the station of a par- 
ticular terminal is requested, the number returned is the 
physical location of the terminal, which may or may not 
be the location of the controlling job. This depends on 
whether the user changed his job's logical location with 
the LOCATE command. 

Clear the directory of the output device. 
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•ASK STATEMENTS 

The BASIC statements used in this manual are briefly de 
scribed below. More detailed information tan be obtained 
from the BASIC CONVERSATIONAL LANGUAGfc 
MANUAL (DEC-IO-LBLMA A D> 



Tear here and fold in thirds 

ALGOL STATEMENTS 

The AL(H)L statements used in this manual are briefly de- 
scribed below More detailed information can be obtained 
from the ALGOL PROGRAMMIRS REFERENCE 
MANUAL (DEC 10 KA/.B D) 



FORTRAN 10 STATEMENTS 

The FORTRAN- lOsutemenis used in this manual are briefly 
described below More detailed information may be obtained 
from the FORTRAN 10 Language Manual (DEC 10- 
LFORA-B-D) 



END 



Indicates the end of the program and must be the state- 
ment with the highest line number. This statement is al- 
ways required. 



IF expression. GOTO lute-number 

Transfers control to the statement at the line number 
specified if the given expression is true 



BEGIN 

Indicates the beginning of a block of compound state- 
ments. the block is terminated by an END statement. 



COMMENTfew; 

Indicates that the text which follows is to be treated as a 
comment (the ' symbol may be substituted for the word 
COMMENT I 



ACCEPT statement -label, variable, variable, ..variable 

Allows for the input of data via the user's terminal during 
the execution of a program 



END 

Indicates the physical end of a source program. 

statement -label FORMAT ( 'text formal -specification) 
Allows for the formatting of input and output data. 



INPUT vanable,vanaNe,.. variable 

Allows data to be entered from the user's terminal during 
the execution of a program 



END 



Indicates the end of a block of compound statements 
the block begins with a BEGIN statement. 



TYPE statement -label, variable, .variable 

Outputs the values of the specified variable's) in the for- 
mat specified by the indicated FORMAT statement. 



LET variable » expression 

Assigns the value of the expression to the right of the 
equal sign to the specified variable(s). 



PRINT 



STOP 



\ variable S 
Types out either text strings (which are enclosed 
within quotation marks) or the value of an expres- 
sion. 



Stops the program and its equivalent to GOTO n, 
where n is the line number of the END statement. 



INTEGER variable, variable,..., variable : 

Specifies a list of variable names which are to have in- 
teger values. 



PRINT ( variable, format -expression, format -expression) ; 

Prints the value of the variable specified in the format 
specified. 



READ (voriaftM; 

Associates a value with the specified variable. 



WRITE {format-specification) ; 

Outputs data in the format specified. 



SAMPLE FORTRAN PROGRAM 

TYPE 10 
10 FORMAT (* WHAT ARE THE TWO NUMBERS?) 

ACCEPT 20. X. Y 
20 FORMAT (2F> 

ANSWER = X + Y 

TYPE 30, ANSWER 
30 FORMAT (THE SUM OF THE NUMBERS IS.F7 2) 

END 



NOTES 



SAMPLE BASIC PROGRAM 

100 PRINT "WHAT ARE THE TWO NUMBERS THAT YOU' 

110 PRINT "WANT TO ADD"? 

120 INPUT A 

130 INPUT B 

140 LETC-A + B 

150 PRINT"THE ANSWER IS" 

160 PRINT C 

170 PRINT "DO YOU WANT TO ADD ANOTHER SET" 

110 PRINT "OF NUMBERS?" 

190 INPUT D 

200 IF D- I GOTO 100 

210 PRINT "SEE YOU LATER" 

220 STOP 

230 END 



SAMPLE ALGOL PROGRAM 

BEGIN 
INTEGER S.C, A, 

WRITE ("I2C1 WHAT ARE THE NUMBERS '{IC]") 

READtS) 

READCC); 

A-C+S; 

WRITE C12CJ THE SUM OF ") ; 

PRINT (S.3.3) ; 

WRITE ("AND") ; 

PRINT (C.3.3); 

WRITE ("IS") ; 

PRINT (A.3,3); 

WRITE ("12C1") ; 
END 
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REMOTE TERMINALCOMMl NIC ATIONS 

1 Turn on ihe terminal 

2 Check ihe speed selling of ihe lerminal (mosi terminals 
are labeled eilher IOC PS. 15 CPS.and 30CPSor 110 baud. 
1 50 baud, and 300 baud) It should initially be sei loeaher 
10 CPS or 1 10 baud 

3 Dial ihe phone number to the computer 

4 Wait for a steady lone 

5 Lay ihe phone receiver in ihe slots provided for it either 
on the terminal or on the acoustic coupler 

6 Wait for the carrier delect light locome on 

7 If you see nothing printed on the terminal, type two 
CTRL/Cs until you see eilher the prompt character or ihe 
words PLE ASE LCX]IN OR ATTACH 

8 Follow Sieps I through 7 of the LOGGING IN PROCE- 
DURE 



UM,(,IN(, IN PR(M EDLRE 

1 Type a CTRL/C 

2 After the period prompt character, type L IKilN 

3 Press the RETURN key 

4 After the system prints #, type your protect -programmer 
number. 

5 Press the RETURN key. 

6 After the system types PASSWORD , type your pass nvrd 

7 Press ihe RETURN key 



I OGGING-OFF PR(X EDI RE 

1 After ihe prompt character, type kit 

2 Press the RETURN key. 



1 When using BASIC . type Ihe command BYE 

2 Press ihe RE URN key 



DELETE A LINE 

1 TypeaCTRL/U 

2 The system will advance the carriage down one line and 
over to the first character position 

3 Type your >;ew line. (HINT If you are entering a file and 
the system is printing line numbers for you, do not type 
the line number over again I 

4 Press Ihe RETURN key 



VIEWING A CORRECTED UNE 

1 Correct the fine using the RUBOUTkey. 

2 Before you press the RETURN key, type CTRL/R 

3 View the corrected line If it is acceptable, press the RE- 
TURN key If it is not acceptable, repeat steps i through 3 
until the line is acceptable or use the CTRL/U feature 



DELETE ONE OR MORE CHARACTERS 

1 Press the RUBOUT ke\ once for each character you want 
to delete 

2 Type the corrected ImeUom the point of deletion 

3 Press the RETURN key 



EDITING A PROGRAM 

1 After the prompt character, tspe RSOS 

2 After FILE is printed, type the name of the tile you want to 
edit 

3 The system will type I DIT followed by your file name 

4 After the ", type one of the SOS commands 



SOS COMMANDS 



FAIT FRO VI THE SOS EDITOR 

1 If you are in input mode (SOS types line numbers for 
you ), pre v the ESC key. 

2 Alter the *, type E 

3 Press the RETURN key 



1 If you are in uimmjnd mode, rip? £ after the * 

2 Press the RE TlRSkcv 



EXECUTING A I SER PROGRAM 

1 After the prompt character, type EXEC I TE 

2 T\pe a \puie lollvnedb\ the program name . 

3 Press the Rr.TLR\ key 



STOP A I SER PROGRAM 

I T\pei*oCTRl./Cs 

LISTING A PROGRAM 

On a terminal 

1 Type the word J i PE. alter the prompt character 

2 Type the name of the fife vou want lobe listed 

3 PresstheRETlRSkci 

On ihe line primer 

1 Alter the prompt character. upeQI.P'l = 

2 Type ihe name of the tile >ou want to be listed 

3 Press the RETlR\kes 

I 'sing BASIC 

1 Type the m>rd I IS I 

2 Press ihe REH H\A,. 



CREATING A FILE 

1 Alter (he prompt character, type R SOS 

2 After EILE is printed, type the name ol your file 

3 The system will print INPUT followed hy your file name 

4 Alter ihe system prints a line number. t\pe a line of your 
file 

5 Press ihe RhTURN key 

6 Repeat steps 4 and 5 unii! you have entered the entire file 

7 Press Ihe LSC key 

8 After the system prints a '. type E 

9 Press the RETURN key 



Print a Line 

Print a Series 

of Lines 

Insert a Line 

Delete a Line 



formal 
•P line* J 

*? line - line *J 

•Vine » J 

•Dime* J 



Replace a Line •Rime* J 

Changing a Line *Sie.\lSie\(%lme#J 
Exit from SOS *E J 



example 
•PI 300 

•P500-700 

•1750 

•D800 

•R900 

•SabcSadcSLUK) 
•E 



LISTING NAMESOE FILES IN VOIR DISK AREA 

1 After the pnimpi character. i\pe IHRECT 

2 Press the R(TlR\kcx 



RENAMING A FILE 

1 After the prompt Lharacier, t\pe the word RE\A\1E. 

2 1 \pe a spaic lollowcd b\ ihcne* fdename 

3 1 ype an equal sian tallowed by ihe old tile name 
A Press the REILRNkcs 



INDEX 



ALG, 12 

ALGOL 
sample program, 14 
execute a program in, 

ALT MODE key, v 

Asterisk, 23 
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.BAS, 12 
BASIC 

entering a file in, 39, 41 

listing a program in, 46 

running a program, 39, 41, 45 

sample program, 42 

saving a program, 39, 41 

using, 39-49 
BASIC commands 

LIST, 46 

REPLACE, 44 

RUN, 39, 41, 45 

SAVE, 39, 41 

Carriage return, v, 4 
CBL, 12 
Change 

a line (in SOS), 24, 29 

a FORTRAN program, 25 

an ALGOL program, 26 
Checking a program, 20 
Command argument, 5 
Commands 

COPY, 34, 37 

DAYTIME, 6 

DELETE, 33 

DIRECT, 33, 35 

EXECUTE, 17, 19 

HELP, 34, 36 

K/F, 6 

LOGIN, 5 

RENAME, 37 

RUN, 34 

SYSTAT, 7 

TYPE, 25, 26, 30 
Compiler, 19 
Control characters 

CTRL/C, 4, 18, 21 

CTRL/I, 13 



CTRL/O, 7 

CTRL/T, 20 
Conventions, v 
COPY command, 34, 37 
Copying a file, 34, 37 
Correcting a program, 26 
CTRL key, v, 3 
CTRL/C, 4, 18, 21 
CTRL/I, 13 
CTRL/O, 7 
CTRL/T, 20 

DELETE command, 33, 35 
Delete 

a file, 33, 35 

aline, 24, 28 
DAYTIME command, 6 
DIRECT command, 33, 35 

Entering 

a file (SOS), 12, 23 

a BASIC program, 41 
Editing 

a BASIC program, 44 

a program, 12, 23, 25, 27 

a file, 12, 23, 25, 27 
Erase 

a character, 15 

aline, 24, 28 
ESCape key, v, 4, 13 
EXECUTE command, 17, 19, 20, 34, 38 
Execution 

of an ALGOL program, 20 

of another user's program, 34,38 

of a BASIC program, 45 

of a FORTRAN program, 20 

of a program, 17, 19 

stopping, 21 
Extensions, file name, 12 

Files 
definition of, ii 
delete a, 33, 35 
editing, 23, 25 
entering a, 12 
extensions to file names, 12 
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list names of, 33, 35 

names of, ii 

renaming, 37 
FORTRAN program, 14, 19 
.FOR, 12 

HELP command, 34, 36 

Insert a line, 23, 28 
Interrupting 

the system, 4 

a program, 21, 28 

K/F command, 6 

Line numbers 

in BASIC, 41 

in SOS, 13 
List 

names of files, 33, 35 

of TOPS- 10 commands App. 
LIST command, 46 
LOGIN command, 5 
Logging-in, 5 
Logging-off, 6 

.MAC, 12 



Passwords, 3 
Period, 4 
PPN, 3 

PREFIX key, v 
Print a line, 23, 27 
Program 

checking a, 20 

definition of, ii 

editing a, 23, 25 

editing a BASIC, 44 

execute a, 17, 19 

execute a BASIC, 43, 45 

saving a BASIC, 43 

stop a, 21, 28 

typing a, 30 



Project-programmer numbers, 3 
Prompt character 

system (.). 4 

SOSC). 23 



.REL 19 

Rename a file, 37, 38 

RENAME command, 37 

Replace a line, 24. 28 

REPLACE command (BASIC), 42 

RUBOUTkey, v. 4, 15 

RUN command (BASIC), 39, 45 

RUN command (TOPS- 10), 34 

SAVE command (BASIC), 43 
SAVE command (TOPS- 10), 39 
Saving 

a file. 24, 29 

a BASIC program, 43 
SOS commands 

change a line (S), 24, 29 

delete a line (D), 24, 28 

insert a line (I), 23, 28 

print a line (P), 23, 27 

replace a line (R), 24, 28 

save a file (E), 24, 29 
SOS editor 

start the, 23, 27 

line numbers, 13 

using, 12, 23, 13, 
Source language, 19 
Stopping a program, 
SYST AT command, 



27 

18, 

7 



21 



13 



TAB key, vi, 

Terminals, 3 

TOPS- 10 commands App. 

Translation, 19 

TYPE command. 25, 26. 

Typing a program. 30 

Typing mistakes, 13, 15 



30 



Index-2 



DECsystem-IO 

Getting Started with DECsystem-IO 

DEC-XGSDA-A-D 



READER'S COMMENTS 



NOTE: This form is for document comments only. Problems 
with software should be reported on a Software 
Problem Report (SPR) form (see the HOW TO OBTAIN 
SOFTWARE INFORMATION page) . 



Did you find errors in this manual? If so, specify by page. 



Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 



.-c 

4- 

0» 



"5 Is there sufficient documentation on associated system programs 

Jj required for use of the software described in this manual? If not, 

§ what material is missing and where should it be placed? 



Please indicate the type of user/reader that you most nearly represent. 

| | Assembly language programmer 

f "~) Higher-level language programmer 

I | Occasional programmer (experienced) 

I | User with little programming experience 

I | Student programmer 

I I Non-programmer interested in computer concepts and capabilities 

Name Date 

Organization 

Street . 

City State Zip Code 

or 
Country 

If you do not require a written reply, please check here. Q 



-Do Not Tear - Fold Here and Tape 




No Postage 

Necessary 

if Mailed in the 

United States 



BUSINESS REPLY MAIL 

FIRST CLASS PERMIT NO. 33 MAYNARD MASS. 



POSTAGE WILL BE PAID BY ADDRESSEE 



SOFTWARE PUBLICATIONS 

200 FOREST STREET MR1-2/E37 
MARLBOROUGH, MASSACHUSETTS 01752 




Do Not Tear - Fold Here and Tape 



c 

O 

Q 
be 

c 
o 



3 
U 



